home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / os2 / memsz313.zip / SOURCE.ZIP / ENGLISH.ZIP / ENGLISH.IPF < prev    next >
Text File  |  1996-03-18  |  15KB  |  344 lines
  1. #include "memsize.h"
  2. :userdoc.
  3. :title.'System Resources' Help
  4. :body.
  5.  
  6. :h1 res=ID_MAIN.Introduction
  7. :i1.Introduction
  8. :artwork name='memsize.bmp' align=center.
  9. :p.
  10. This program displays several items related to system resources,
  11. and updates the display once per second, providing it is given
  12. CPU time to do so.  The items displayed are:
  13. :p.
  14. :hp2.Date/Time:ehp2. - The current date and time, in the format called for
  15. in the default country information for your system, as specified in
  16. the &apos.COUNTRY=&apos. entry of your CONFIG.SYS file.
  17. :p.
  18. :hp2.Elapsed Time:ehp2. - The elapsed time since the computer
  19. was last restarted.
  20. :p.
  21. :hp2.Physical Memory Free:ehp2. - The amount of system memory
  22. available, according to the :hp1.DosMemAvail:ehp1. function.
  23. :note.This function is part of the old 16-bit system, and only reports
  24. physical memory below 16Mb, and was also altered just before
  25. OS/2 2.0 was released to never report less than 512K.
  26. #ifdef USE_OS20MEMU
  27. :note.If the utility program :hpt.OS20MEMU:ehpt.:hdref res=60001. 
  28. and its device driver are installed, this number will be correct, 
  29. at the cost of a higher CPU load.
  30. #endif
  31. :p.
  32. :hp2.Virtual Memory Free:ehp2. - The amount of virtual memory
  33. available, according to the :hp1.DosQuerySysInfo:ehp1. function.
  34. This is the amount of free physical memory, plus the amount of
  35. free space within the current swapping file, plus the amount of
  36. space by which the swapping file could yet grow, less the amount
  37. of free space reserved on the swapping drive.
  38. :p.
  39. :hp2.Swap File Size:ehp2. - The current size of the system
  40. virtual memory swap file, SWAPPER.DAT.
  41. To locate the file, the file CONFIG.SYS is scanned for its SWAPPATH entry.
  42. That entry provides the full name of the swap-file's directory and
  43. indicates the minimum free space that must be left on the swap-file's
  44. disk drive.
  45. :p.
  46. :hp2.Available Swap Space:ehp2. - The amount of free disk space on the
  47. logical disk drive where the system swap file resides, less the mininum
  48. free space.  This is how much more the swap file could expand, if necessary.
  49. :p.
  50. :hp2.Unused Swap Space:ehp2. - The amount of free space within the currently
  51. allocated system swap file.  When this drops to zero, the system swap file
  52. must be increased in size, normally by one megabyte at a time.
  53. :p.
  54. :hp2.Spool File Size:ehp2. - The amount of disk space consumed by spool files.
  55. :p.
  56. :hp2.CPU Load (%):ehp2. - The approximate percentage of the CPU's available
  57. horsepower that's being used at the moment.  It is averaged over the previous
  58. second.
  59. :note.This function and PULSE do not get along with each other.  
  60. :hpt.Why?:ehpt.:hdref res=60002.
  61. :note.If you have the driver :hpt.HRTIMER.SYS:ehpt.:hdref res=60000. 
  62. installed, this number will be more accurate.
  63. :hpt.Why?:ehpt.:hdref res=60003.
  64. :p.
  65. :hp2.Active Task Count:ehp2. - The number of entries in the system switch list,
  66. which is the list displayed when you press CTRL+ESC.
  67. :note.Not all entries in the system switch list are displayed in the
  68. Window List.  Some are marked for non-display.
  69. :p.
  70. :hp2.Process Count:ehp2. - The number of processes currently loaded
  71. on the system.
  72. :p.
  73. :hp2.Thread Count:ehp2. - The number of threads currently running
  74. on the system.  There is at least one thread for each process.
  75. :p.
  76. :hp2.Total Free Disk Space:ehp2. - The amount of free space on all the
  77. local non-removable disks combined.
  78. :p.
  79. :hp2.Drive X Free:ehp2. - The amount of free space on drive X.
  80. :p.
  81. The help facility is active, as you've already seen, and those program
  82. commands that exist may be accessed via the window's system menu.  The
  83. following commands are available:
  84. :sl compact.
  85. :li.:hpt.Save Settings:ehpt.:hdref res=IDM_SAVE_APPLICATION.
  86. :li.:hpt.Reset Defaults:ehpt.:hdref res=IDM_RESET_DEFAULTS.
  87. :li.:hpt.Hide Controls:ehpt.:hdref res=IDM_HIDE_CONTROLS.
  88. :li.:hpt.Configure...:ehpt.:hdref res=IDM_CONFIGURE.
  89. :li.:hpt.Reset Load Meter:ehpt.:hdref res=IDM_RESETLOAD.
  90. :li.:hpt.Copy:ehpt.:hdref res=IDM_COPY.
  91. :li.:hpt.About:ehpt.:hdref res=IDM_ABOUT.
  92. :li.:hpt.Close:ehpt.:hdref res=IDM_EXIT.
  93. :esl.:p.
  94. In addition to those features already described, this program accepts
  95. commands from the OS/2 2.0 Font and Color Palette programs, and is a
  96. DDE server for all the currently displayed items.  The DDE application
  97. name is MEMSIZE, and the item names are the same as the default display
  98. item names (like Physical Memory Free).
  99.  
  100. :h1 res=IDM_SAVE_APPLICATION.Save Settings (Menu Option)
  101. :i1.Save Settings (Menu Option)
  102. When you select this menu option, the program saves its current position
  103. and the status of the Hide Controls option.  The next time the program
  104. is started, it will be started with that position and with the controls
  105. hidden (or not) according to the saved state.
  106. :p.
  107. The short-cut key for this command is F2.
  108.  
  109. :h1 res=IDM_RESET_DEFAULTS.Reset Defaults (Menu Option)
  110. :i1.Reset Defaults (Menu Option)
  111. Selecting this menu option will reset the program's font and color
  112. attributes to their default values.
  113.  
  114. :h1 res=IDM_HIDE_CONTROLS.Hide Controls (Menu Option)
  115. :i1.Hide Controls (Menu Option)
  116. This menu option, when selected, will cause the program's frame controls
  117. (the system menu, the titlebar and the minimize button) to be hidden.
  118. This option can be toggled with a double-click on either mouse button.
  119. Also, since I saw it as very useful to be able to move the window while
  120. the controls were hidden, the window has been set up so that you can
  121. drag it with either mouse button.
  122. :p.
  123. The key combination Alt+H will perform this function also.
  124.  
  125. :h1 res=IDM_CONFIGURE.Configure (Menu Option)
  126. :i1.Configure (Menu Option)
  127. This menu option, when selected, will cause the program's configuration
  128. dialog to be displayed.
  129. For more information, see :hpt.Configure (Dialog):ehpt.:hdref res=IDD_CONFIGURE..
  130. :note.The short-cut key to this option is Alt+C.
  131.  
  132. :h2 res=IDD_CONFIGURE.Configure (Dialog)
  133. This dialog allows you to change all configurable aspects of this
  134. program's operation.  To escape without effecting any changes, press
  135. the ESCAPE key or click on the Escape pushbutton.
  136. To save the changes you've made, press the ENTER key
  137. or click on the OK pushbutton.
  138. .br
  139. The configurable items include the following:
  140. :p.
  141. :hp2.Display Items:ehp2.
  142. You may select any or all of the items in the Display Items list for monitoring
  143. and display.  
  144. Simply click on an item to highlight it, click again to remove the highlight.
  145. Highlighted items are monitored.
  146. To change an item's default label, or to restore the default label, double-click
  147. on an unselected item.  The item will be selected and a dialog presented
  148. from which you may alter the item label.
  149. :p.
  150. :hp2.Show 'K'ilobytes:ehp2.
  151. This group of radiobuttons allows you to select whether large sizes
  152. are displayed in kilobyte notation always, never, or only when their
  153. values exceed 512K.  
  154. The default is to show all sizes over 512K in this way.  
  155. Keep in mind that one kilobyte is actually 1024 bytes, not 1000.
  156. :p.
  157. :hp2.Monitor Priority:ehp2.
  158. This control allows you to set the absolute priority of the monitoring
  159. thread of the program, within the time-critical priority class.
  160. You may vary the priority from 0 to 31.  Priority 31 is the highest
  161. possible priority in the system, short of physical interrupts.
  162. Priority 0 is simply the lowest priority within the time-critical class.
  163. Normally, you should set this to the maximum for more accuracy in
  164. system monitoring.  However, some have complained that their communications
  165. programs occasionally miss data while this program is running.  For that
  166. reason the priority is now variable.
  167. :p.
  168. :hp2.Timer Interval:ehp2.
  169. This control allows you to set the interval between monitor window
  170. updates.  It can be varied from 1.0 seconds to 30.0 seconds, in
  171. steps of 1/10 second.  The number displayed is in tenths of a second.
  172. :p.
  173. :hp2.Window Anchor:ehp2.
  174. This control allows you to set the corner of the monitor window which
  175. remains fixed in position when the window size changes.  The monitor
  176. window can change in size when items are added or removed from the active
  177. list, and when the display font is changed from the Font Palette.
  178. :p.
  179. :hp2.Hide Controls:ehp2.
  180. When the program window is not iconized, it can be shown with or without the usual
  181. title bar, system menu and minimize/maximize buttons.  If you chose to
  182. hide these controls, the window may still be positioned by dragging its
  183. center area.
  184. :p.
  185. :hp2.Float to Top:ehp2.
  186. This button activates an window's float-to-top function.
  187. When this button has been check-marked, the clock will float to the top
  188. of the window stack, making itself visible all the time.
  189. :p.
  190. :hp2.Animate:ehp2.
  191. This button activates the window open &. close animation feature.
  192. When this is active, the program window will open and close in the
  193. same way as the folder objects do: with sound and motion.
  194. As with folders, animation will not occur unless it has been
  195. enabled at the system level.
  196. :p.
  197. :hp2.Show File System Names:ehp2.
  198. This button causes the individual drive free space entries to show the type
  199. of file system in use with the drive.  Use of this option results in
  200. a wider monitor window.
  201. :p.
  202. :hp2.Show Disk Labels:ehp2.
  203. This button causes the individual drive free space entries to show their
  204. disk labels.  Use of this option results in a wider monitor window.
  205. :p.
  206. :hp2.Show Seconds:ehp2.
  207. This button causes the clock and elapsed time displays to include the
  208. seconds of the minute.
  209.  
  210. :h3 res=IDD_LABEL.Set Item Label (Dialog)
  211. This dialog box displays the current and default label for a display item,
  212. and allows you to alter it.  To change the label, simply type the new
  213. label over the current one.  To restore the label to its default,
  214. click on the Default button.
  215.  
  216. :h1 res=IDM_RESETLOAD.Reset Load Meter (Menu Option)
  217. :i1.Reset Load Meter (Menu Option)
  218. This menu option allows the user to reset the CPU Load meter,
  219. recalibrating it, causing it to forget previous CPU activity in its
  220. calculations.
  221.  
  222. :h1 res=IDM_COPY.Copy (Menu Option)
  223. :i1.Copy (Menu Option)
  224. This menu option copies the current window display to the system
  225. clipboard in two formats: Text and Bitmap.  The text version
  226. shows all the currently displayed items in a form suitable for
  227. pasting into a text editor.  The bitmap version shows an exact
  228. copy of the current window, and can be used by graphic editors
  229. and viewers.
  230. :p.
  231. The short-cut key for this command is Ctrl+Ins.
  232.  
  233. :h1 res=IDM_ABOUT.About (Menu Option)
  234. :i1.About (Menu Option)
  235. This menu option, when selected, will cause the program's About dialog
  236. to be displayed.
  237. For more information, see :hpt.About (Dialog):ehpt.:hdref res=IDD_ABOUT..
  238.  
  239. :h2 res=IDD_ABOUT.About (Dialog)
  240. This dialog box displays the program name, icon and copyright information.
  241. To exit the dialog, press the ENTER key, the SPACE bar or the ESCAPE key,
  242. or click on the OK button with the mouse.
  243.  
  244. :h1 res=IDM_EXIT.Close (Menu Option)
  245. :i1.Close (Menu Option)
  246. This menu option, when selected, will cause the program to terminate.
  247.  
  248. :h1 res=IDM_KEYS_HELP.Keys Help
  249. :i1.Keys Help
  250. The following function keys have been defined for this program:
  251. :sl compact.
  252. :li.F1 - Help
  253. :li.F2 - Save Settings
  254. :li.F3 - Exit
  255. :li.Alt+C - Configure
  256. :li.Alt+H - Hide Controls
  257. :li.Ctrl+Ins - Copy
  258. :esl.:p.
  259.  
  260. :h1 res=IDD_PROFILE_PATH.Set Profile Path (Dialog)
  261. :i1.Set Profile Path (Dialog)
  262. This dialog is displayed when the program cannot find its profile (INI) file,
  263. and asks you where the file is or where it is to be created.
  264. :p.
  265. Only a valid existing directory name will be accepted.
  266. Once you have entered the name, press the ENTER key or click on the OK
  267. button for the program to continue.
  268. :p.
  269. If you wish to abort the program's initialization sequence, press
  270. the ESC key or click on the escape button.
  271.  
  272. :h1 res=60000.HRTIMER - High Resolution Timer driver
  273. The high resolution timer device driver, HRTIMER.SYS, enables a program
  274. to access a normally unused timer chip found on IBM PCs.  It has a resolution
  275. as high as 840 nanoseconds, 64K times better than the normal timer resolution 
  276. of 55 milliseconds.
  277. :p.
  278. The only places I know of right now that has this program available are 
  279. :hp4.CompuServe:ehp4., 
  280. where the program can be found in the 
  281. :hp4.Device Driver Development:ehp4.
  282. library of the 
  283. :hp4.OS/2 Developer's Forum I (OS2DF1):ehp4., 
  284. under the name 
  285. :hp4.TIMER.ZIP:ehp4.,
  286. and on the anonymous ftp sites
  287. :hp4.ftp.cdrom.com:ehp4. 
  288. and 
  289. :hp4.hobbes.nmsu.edu:ehp4..
  290. The file can be found in the directory 
  291. :hp4./pub/os2/dev16:ehp4.,
  292. as 
  293. :hp4.hrtimer.zip:ehp4..
  294. :p.The source code for this device driver was obtained from the Fall 1991 issue of
  295. IBM Personal Systems Developer magazine.  It is freeware, but the original
  296. copyright belongs to IBM.
  297.  
  298. #ifdef USE_OS20MEMU
  299. :h1 res=60001.OS20MEMU - OS/2 Memory Utilization Map
  300. The utility program OS20MEMU, together with its special device driver,
  301. screen files and DLLs, allow the user to get an exhaustive listing
  302. of all memory usage by any programs on their OS/2 system, or by the
  303. system itself.  
  304. :p.The only places I know of right now that has this program available
  305. are the anonymous ftp sites 
  306. :hp4.ftp.cdrom.com:ehp4. 
  307. and 
  308. :hp4.hobbes.nmsu.edu:ehp4..
  309. The file can be found in the directory 
  310. :hp4./pub/os2/textutil:ehp4., 
  311. as 
  312. :hp4.20memu.zip:ehp4..
  313. :p.OS20MEMU is freeware, written and copyrighted by IBM.
  314. :note.Make sure to use the version dated November 1994 (or later), as the
  315. earlier versions do not work with Warp.
  316. #endif
  317.  
  318. :h1 res=60002.What is the conflict with PULSE?
  319. This program, as well as PULSE, CPULOAD, CPUMETER and similar programs,
  320. all attempt to measure how busy the computer is by trying to see how much
  321. work they can accomplish at the lowest possible priority.  Presumably, if
  322. one of these programs can do anything at that priority, it must be using
  323. idle time.  If there is no idle time, the computer is 100% busy.  The more
  324. this program can do at system idle priority, the less busy the computer
  325. is assumed to be.
  326. :p.The problem with running more than one of these programs at the same
  327. time is that they begin to compete for that idle time.  If you ran two
  328. copies of the same program, and nothing else, they should both show
  329. about 50% CPU load.  If you run two disimilar programs, like this one
  330. and PULSE, they would both be affected, but usually to differing degrees.
  331.  
  332. :h1 res=60003.How does HRTIMER.SYS help?
  333. With HRTIMER.SYS installed, system overhead is included in the CPU Load.
  334. :p.
  335. The CPU Load is determined by comparing how much work could be done at
  336. idle priority with the most the program has been able to do up to the
  337. present moment.  Without more information, normal system background 
  338. activity would appear as zero load.  If HRTIMER.SYS is installed on your
  339. system, then this program executes a calibration loop at startup, in which
  340. it determines just how much work can be accomplished at the highest 
  341. possible priority.  This amount is then used for comparison.
  342.  
  343. :euserdoc.
  344.